package com.yupi.springbootinit.service;

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.extension.service.IService;
import com.yupi.springbootinit.model.dto.user.UserQueryRequest;
import com.yupi.springbootinit.model.dto.user.UserUpdateMyPasswordRequest;
import com.yupi.springbootinit.model.entity.User;
import com.yupi.springbootinit.model.vo.DepartmentUserStatVO;
import com.yupi.springbootinit.model.vo.LoginUserVO;
import com.yupi.springbootinit.model.vo.UserStatisticsVO;
import com.yupi.springbootinit.model.vo.UserVO;
import java.util.List;
import jakarta.servlet.http.HttpServletRequest;

/**
 * 用户服务
 */
public interface UserService extends IService<User> {

    /**
     * 用户注册
     *
     * @param userAccount   用户账户
     * @param userName      用户名称
     * @param userPassword  用户密码
     * @param checkPassword 校验密码
     * @param departmentId  部门ID
     * @return 新用户 id
     */
    long userRegister(String userAccount, String userName, String userPassword, String checkPassword, Long departmentId);

    /**
     * 用户登录
     *
     * @param userAccount  用户账户
     * @param userPassword 用户密码
     * @param request
     * @return 脱敏后的用户信息
     */
    LoginUserVO userLogin(String userAccount, String userPassword, HttpServletRequest request);



    /**
     * 获取当前登录用户
     *
     * @param request HTTP请求
     * @return 当前登录用户
     */
    User getLoginUser(HttpServletRequest request);

    /**
     * 获取当前登录用户（允许未登录）
     *
     * @param request HTTP请求
     * @return 当前登录用户，可能为null
     */
    User getLoginUserPermitNull(HttpServletRequest request);

    /**
     * 是否为管理员
     *
     * @param request HTTP请求
     * @return 是否为管理员
     */
    boolean isAdmin(HttpServletRequest request);

    /**
     * 是否为管理员
     *
     * @param user 用户信息
     * @return 是否为管理员
     */
    boolean isAdmin(User user);

    /**
     * 用户注销
     *
     * @param request HTTP请求
     * @return 注销结果
     */
    boolean userLogout(HttpServletRequest request);

    /**
     * 获取脱敏的已登录用户信息
     *
     * @param user 用户信息
     * @return 脱敏的登录用户信息
     */
    LoginUserVO getLoginUserVO(User user);

    /**
     * 获取脱敏的用户信息
     *
     * @param user 用户信息
     * @return 脱敏的用户信息
     */
    UserVO getUserVO(User user);

    /**
     * 获取脱敏的用户信息
     *
     * @param userList 用户列表
     * @return 脱敏的用户信息列表
     */
    List<UserVO> getUserVO(List<User> userList);

    /**
     * 获取查询条件
     *
     * @param userQueryRequest 用户查询请求
     * @return 查询条件包装器
     */
    QueryWrapper<User> getQueryWrapper(UserQueryRequest userQueryRequest);

    /**
     * 管理员新增/更新用户校验逻辑
     *
     * @param user 用户信息
     * @param isCreate 是否为创建操作
     */
    void validateAdminUser(User user, boolean isCreate);

    /**
     * 更新我的密码
     *
     * @param loginUser 当前登录用户
     * @param userUpdateMyPasswordRequest 密码更新请求
     * @return 更新结果
     */
    boolean updateMyPassword(User loginUser, UserUpdateMyPasswordRequest userUpdateMyPasswordRequest);

    /**
     * 解锁用户
     *
     * @param userAccount 用户账号
     * @return 解锁结果
     */
    boolean unlockUser(String userAccount);

    /**
     * 获取用户统计信息
     * @return 用户统计信息
     */
    UserStatisticsVO getUserStatistics();

    /**
     * 获取各部门用户统计信息
     * @return 各部门用户统计列表
     */
    List<DepartmentUserStatVO> getDepartmentUserStatistics();

    /**
     * 是否为部门负责人
     *
     * @param user 用户信息
     * @return 是否为部门负责人
     */
    boolean isDeptLeader(User user);

    /**
     * 检查用户是否可以管理指定用户（部门负责人权限）
     *
     * @param manager 管理者用户
     * @param targetUserId 目标用户ID
     * @return 是否可以管理
     */
    boolean canManageUser(User manager, Long targetUserId);

    /**
     * 获取部门负责人可管理的用户查询条件
     *
     * @param deptLeader 部门负责人
     * @param userQueryRequest 用户查询请求
     * @return 查询条件包装器
     */
    QueryWrapper<User> getDeptLeaderQueryWrapper(User deptLeader, UserQueryRequest userQueryRequest);
}
